.. _ecmSxMot_MoveStart_InTime:

ecmSxMot_MoveStart_InTime
=========================
-------------------------

.. Hint::
   :ref:`Fast Function(_FF)  <ECAT_Appendix_00>`  사용 가능
   
   :ref:`ECAT_Appendix_03`  참고 

SYNOPSIS
--------


.. code-block:: none

  t_cmdidx ecmSxMot_MoveStart_InTime(_FF)
    t_i32 NetID,
    t_i32 Axis,
    t_f64 Distance,
    t_f64 TimeSec,
    t_i32 Errcode
  )



DESCRIPTION
-----------


-하나의 축에 대해 현재의 위치에서 지정한 거리(상대 위치)만큼 이동을 수행하며, 지정한 시간 내에 함수를 반환합니다.



PARAMETER
---------


- NetID : Network 번호

- Axis : 대상 축 번호 

- Distance : 이동할 거리를 지정합니다.

- TimeSec : 반환하기까지의 시간을 지정합니다. 

- Errcode : 이 매개 변수를 통하여 현재의 에러 코드를 반환합니다. 단, 이 매개 변수에 NULL을 전달하면 에러 코드를 반환하지 않습니다.





RETURN VALUE
------------


- CmdIdx를 반환 합니다. CmdIdx는 ComiECAT SDK라이브러리에서 발생시킨 명령들의 일련 번호입니다. 단, 이 값이 0이면 함수의 수행이 실패했음을 의미합니다.

+-------+--------------------------------------+
| Value | Meaning                              |
+=======+======================================+
| 0     | 함수 수행에 실패하였음을 의미합니다. |
+-------+--------------------------------------+
| 1     | 함수 수행에 성공하였음을 의미합니다. |
+-------+--------------------------------------+